home *** CD-ROM | disk | FTP | other *** search
/ Floppyshop 2 / Floppyshop - 2.zip / Floppyshop - 2.iso / art&graf.ix / art-5112 / mc_fli / mc_fli_g.doc < prev    next >
Text File  |  1995-11-19  |  18KB  |  481 lines
  1. McFli V0.7
  2. Ein Animationsplayer für Computer mit TOS-kompatiblem Betriebssystem 
  3.  
  4. "Wer McFli nachmacht, oder verfälscht, oder verfälschte oder nachgemachte 
  5. Kopien von McFli in Umlauf bringt, wird mit 'Four Roses' nicht unter zwei 
  6. Litern bestraft"
  7.  
  8. 1. Einleitung:
  9.  
  10. ACHTUNG! WICHTIG! BITTE LESEN!
  11. -----------------------------------------------------------------------------
  12. Erst mal das wichtigste: McFli ist Shareware! Das bedeutet, die Benutzung 
  13. ist nicht unentgeltlich; allerdings darf man McFli ein paar (max. vier) 
  14. Wochen testen. Dann erst wird die Zahlung fällig.
  15.  
  16. Aber erst mal keine Bange. Alle Versionen 0.xx sind kostenlos, da es sich 
  17. eigentlich noch um Vorversionen handelt. Erst ab der Version 1.0 ist die 
  18. Zahlung eines Betrages (den ich noch nicht festgelegt habe) Pflicht.
  19.  
  20. Der werte Leser möge bedenken, daß es dabei völlig gleich ist, ob er/sie 
  21. das Programm kostenlos erhielt, oder ob es sich auf einer Diskette, CD 
  22. o.Ä. befand, für die er/sie zahlen mußte. Von diesen Verkaufsgebühren sehe 
  23. ich keinen Pfennig, es sei denn, es ist ausdrücklich darauf hingewiesen 
  24. worden (z.B. "incl. Vollversion von McFli" oder so ähnlich)
  25.  
  26. Wer mir allerdings jetzt schon etwas Geld zukommen lassen will, bitte 
  27. schön. Alles >= DM 10,- wird als Sharewaregebühr bis zur Version 2.0 
  28. (ausschließlich) akzeptiert.
  29.  
  30. Und noch eine Bitte: Falls das Programm muckt, nicht funktioniert oder in 
  31. ein paar Punkten nicht ganz den eigenen Wünschen entspricht, bitte an mich 
  32. weitermelden, anstatt das Programm gleich in die Tonne zu treten.
  33.  
  34. Und zum Schluß der Einleitung: McFli darf (und soll) verbreitet werden. 
  35.  
  36. Allerdings mit folgenden Einschränkungen: 
  37.  
  38. - McFli darf nur komplett verbreitet werden. Zu McFli gehören folgende Dateien:
  39.  
  40.     MC_FLI.APP    Das Programm
  41.     MC_START.APP  Hilfsprogramm
  42.     MC_FLI.RSC    Das Resourcefile
  43.     MC_FLI_E.RSC  Das englische Resourcefile
  44.     MC_FLI_G.DOC  Die Dokumentation
  45.     MC_FLI_E.DOC  Die englische Dokumentation
  46.     
  47. - McFli darf nur kostenlos verbreitet werden! Reine Kopier- oder Versand-
  48.   gebühren sind davon natürlich ausgeschlossen. Das bedeutet unter anderem:
  49.   Befindet sich McFli auf einem Medium, für dessen Erwerb man bezahlen muß,
  50.   so darf der Kaufpreis nicht den Wert des Leermediums plus Kopierkosten und
  51.   Verpackung überschreiten. Ausnahmen davon sind mit mir abzusprechen (und 
  52.   ggf. vertraglich zu reglen).
  53.  
  54. Ach so, bevor ich's vergesse: Sämtliche Rechte an McFli liegen und bleiben 
  55. bei mir!
  56. -----------------------------------------------------------------------------
  57.  
  58.  
  59. McFli bietet:
  60.  
  61. - Abspielen von Animationen des Typs FLI, FLC, GL
  62. - McFli ist (intern) für andere Animationstypen erweiterbar
  63. - alle Dialogboxen und die Animation in Fenstern (letzteres kann 
  64.   abgeschaltet werden)
  65. - McFli läuft auf Grafikkarten mit 256 Farben
  66. - McFli läuft auch unter Multitasking Betriebssystemen
  67. - Animationen können aus dem Hauptspeicher heraus, oder von einem Masenmedium
  68.   aus abgespielt werden
  69. - McFli versteht die VA_START Meldung
  70. - McFli unterstützt Drag&Drop und Iconify
  71.  
  72.  
  73. Systemvoraussetzungen:
  74.  
  75. Gebraucht wird:
  76.  
  77. - ein Computer mit Betriebssystem TOS (MultiTOS, MagiC, MagiCMac, GENEVA etc.)
  78. - Eine Grafikkarte mit 256 Farben, bzw. ein Mac (unter MagicMac)
  79. - ca. 220kB freien Speicher (für eine FLI/FLC Animation der Größe 320x200)
  80. - eine bis viele FLI, FLC oder GL Animationen
  81.  
  82.  
  83.    
  84. 2. Inhalt:
  85.  
  86.    1. Einleitung
  87.    
  88.    2. Inhalt
  89.    
  90.    3. Installation
  91.    
  92.    4. Die Bedienung
  93.       4.1 Wir wandern durch die Menüleiste...
  94.       4.2 Die Fenster von McFli
  95.           4.2.1 Das Infofenster
  96.           4.2.2 Das Animationsfenster
  97.           4.2.3 Das Steuerfenster
  98.           4.2.4 Das Parameterfenster
  99.           4.2.5 Der Fullscreen-Modus
  100.    
  101.    5. Abweichende Bedienung für verschiedene Animationen
  102.       5.1 FLI/FLC
  103.       5.2 GL
  104.       
  105.    6. McStart
  106.    
  107.    7. Anhang 
  108.    
  109.    8. History
  110.    
  111.    9. Ausleitung
  112.  
  113.  
  114.  
  115.  
  116. 3. Installation:
  117.  
  118. Da gibt's eigentlich nichts zu installieren. Einfach McFli irgendwohin 
  119. kopieren, umrühren, fertig. Es ist lediglich zu beachten, daß der 
  120. Programmname "MC_FLI.APP" lauten muß und das Resourcefile "MC_FLI.RSC" in 
  121. den gleichen Ordner kopiert wird.
  122.  
  123.  
  124. 4. Die Bedienung:
  125.  
  126. 4.1 Wir wandern durch die Menüleiste...
  127.  
  128. McFli
  129.   über McFli...
  130.     Die obligatorische Informationsbox
  131.  
  132.  
  133. Datei
  134.   Öffnen...                          [Control O]
  135.     Der allseits bekannte Fileselector öffnet sich, um ein Animation 
  136.     auszuwählen. Diese wird sodann geladen und in einem Fenster angezeigt. 
  137.     Gleichzeitig wird noch ein Steuerfenster geöffnet, doch dazu später 
  138.     mehr.
  139.     
  140.     Alternativ dazu, kann man Animationen auch noch auf folgende Arten 
  141.     laden:
  142.     
  143.     - McFli im Desktop für die Extender FLI und FLC anmelden. Ein 
  144.       Doppelklick auf eine solche Datei startet dann McFli und die 
  145.       Animation wird abgespielt. Falls der Desktop die VA_START Meldung 
  146.       versenden kann, so kann man jederzeit eine andere Animation öffnen, 
  147.       die dann von McFli gespielt wird.
  148.     
  149.     - Sollte das Betriebssystem Drag&Drop beherrschen, so kann man 
  150.       Anmimationen auf jedes beliebige Fenster von McFli ziehen; sie 
  151.       werden dann geladen.
  152.    
  153.     
  154.   Schließen                          [Control D]
  155.     Das Animationsfenster und das Steuerfenster werden geschlossen
  156.   
  157.   Ende                               [Control Q]
  158.     McFli wird beendet
  159.  
  160.  
  161. Extra
  162.   Fenster wechseln                   [Control W]
  163.     Die Fenster von McFli werden zyklisch rotiert
  164.  
  165.   Fenster schließen                  [Control U]
  166.     Das oberste Fenster wird geschlossen
  167.  
  168.   Fullscreen                          [ESC]
  169.     Schaltet jederzeit vom "Fenster-Modus" in den "Fullscreen-Modus" um.
  170.   
  171.   Parameter einstellen...            [Control E]
  172.     Ein Dialogfenster wird geöffnet, um diverse Parameter von McFli 
  173.     einstellen zu können
  174.  
  175.   Parameter sichern...               [Control S]
  176.     Die Einstellungen aus "Parameter einstellen" können gespeichert werden; 
  177.     McFli lädt sie dann beim nächsten Programmstart ein.
  178.     
  179.     Sollte dieser Menüpunkt nicht anwählbar sein, so hat McFli aus 
  180.     irgendeinem Grund sich selbst (MC_FLI.APP) nicht gefunden, und weiß 
  181.     nicht, wohin es seine INF-Datei schreiben soll.
  182.   
  183.  
  184. 4.2 Die Fenster von McFli:
  185.  
  186. Wie man GEM Fenster bedient, setzte ich mal als bekannt voraus, ebenso die 
  187. Bedienung des iconisierens.
  188.  
  189. Wer sich unter "iconisieren" nichts vorstellen kann, der möge bitte die 
  190. Doku zum beiliegenden ICFS lesen; dort wird dieser Begriff erschöpfend 
  191. erklärt.
  192.  
  193. - Alle Fenster von McFli können gleichzeitig auf dem Bildschirm verweilen.
  194. - Ein Klick auf den Closer wird als OK gewertet.
  195. - Eine Hintergrundbedienung der Fenster ist möglich, d.h. wenn man auf 
  196.   einen Button eines Dialogfensters klickt, wird dieses dadurch nicht 
  197.   automatisch zum obersten Fenster.
  198. - Als Standardshortcut gelten für "OK":      RETURN und Alternate O
  199.                                   "Abbruch": UNDO   und Alternate A
  200.  
  201.  
  202. 4.2.1 Das Infofenster:
  203.   Dazu gibt's nicht viel zu sagen. Anschauen, Info lesen, gut so.
  204.   Das Fenster wird durch den Closer oder durch Klick auf "OK" geschlossen 
  205.   (Control U, Alternate O oder RETURN geht natürlich auch)
  206.  
  207.  
  208. 4.2.2 Das Animationsfenster:
  209.   Darin befindet sich das aktuelle Bild (genannt Frame) der geladenen 
  210.   Animation. 
  211.   Im "Fenster-Modus" läuft die Animation auch in diesem Fenster ab. 
  212.   
  213.  
  214. 4.2.3 Das Steuerfenster:
  215.   Es hat zwei Aufgaben. Zum einen gibt es ein paar Informationen zur 
  216.   Animation aus, zum anderen dient es zur Steuerung der Animation.
  217.   
  218.   Die Infos:
  219.     Zu oberst steht der Name der geladenen Animation
  220.     Darunter stehen Breite, Höhe und Farbtiefe, sowie die Anzahl der 
  221.     Bilder (Frames) der Animation, und in welcher Geschwindigkeit sie 
  222.     abgespielt wird.
  223.     
  224.     Die letzte Zeile kennzeichnet die Stelle der Animation, an der man 
  225.     sich zur Zeit befindet.
  226.   
  227.   
  228.   Die Steuerbuttons (von links nach rechts):
  229.     
  230.     STOP    [S] Die Animation wird angehalten, und der erste Frame angezeigt
  231.     PLAY    [G] Die Animation wird ab dem aktuellen Frame abgespielt 
  232.     PAUSE   [P] Hält die Animation an; im Fenster bleibt der aktuelle Frame
  233.     REWIND  [R] Springt zum letzten Frame  (nur für manche Animationen)
  234.     FORWARD [F] Springt zum nächsten Frame (nur für manche Animationen)
  235.  
  236.     
  237.     Die Tastaturshortcuts sind immer gültig, egal welches Fenster oben 
  238.     ist.
  239.  
  240.  
  241. 4.2.4 Das Parameterfenster:
  242.   Davon gibt's eigentlich zwei. Eines für Auflösungen < 640x200  und eines 
  243.   für höhere Auflösungen. Die verwendeten Titel gelten für das große 
  244.   Fenster; in Klammern stehen die Titel für das kleine.
  245.   
  246.   Alle Einstellungen werden sofort übernommen, können aber mit Abbruch 
  247.   revidiert werden.
  248.   
  249.   
  250.   Allgemeines:
  251.      Fileselector bei Programmstart: [Alternate R]
  252.      (Programmstart: Fileselector)
  253.        Erklärt sich wohl von selbst.
  254.    
  255.      Nachfragen vor Programmende:    [Alternate C]
  256.        Erklärt sich auch selbst.
  257.   
  258.      Variable Fenstergröße:          [Alternate V]
  259.        Normalerweise ist das Animationsfenster genau so groß, wie es zur 
  260.        kompletten Darstellung der Animation nötig ist, bzw. wie es die 
  261.        Bildschirmauflösung zulässt. Ist die Funktion angewählt, so kann 
  262.        man jedoch die Größe des Animationsfensters verändern sowie den 
  263.        dargestellten Inhalt mittels der bekannten Fensterelemente 
  264.        verschieben. Eine Änderung betrifft nicht eine gerade laufende 
  265.        Animation!
  266.      
  267.      Fenster zentrieren:             [Alternate Z]
  268.        Ist diese Funktion aktiv, so werden alle Fenster beim Öffnen in der 
  269.        Mitte des Bildschirms zentriert, ansonsten öffnet sich das Fenster 
  270.        an der letzten Position.
  271.        
  272.     Alle Funktionen sind per Default aktiv.
  273.     
  274.     
  275.   Abspielen :
  276.     Sofort:                          [Alternate S]
  277.       Die Animation wird gleich nach dem Laden abgespielt, ansonsten nur 
  278.       angezeigt.
  279.     
  280.     Endlos:                          [Alternate L]
  281.       Viele Animationen sind als Endlosschleife realisiert. Dem wird 
  282.       hiermit Rechnung getragen, in dem die Animation immer wieder von 
  283.       Vorne gespielt wird (oder auch nicht, je nach Einstellung)
  284.       
  285.     Im Fenster:                      [Alternate F]
  286.       Hier entschließt man sich, ob die Animation im GEM-konformen Fenster 
  287.       (Fenster-Modus"), oder auf dem gesamten Bildschirm ("Fullscreen-Modus")
  288.       laufen soll.
  289.       
  290.       Diese Einstellung hat bei laufender Animation keine Wirkung, sondern 
  291.       erst nach Neustart (Ein Klick auf PLAY genügt).
  292.       
  293.     Volles Tempo:                    [Alternate T]
  294.       Normalerweise wird eine Animation so schnell abgespielt, wie es der 
  295.       "Hersteller" vorsah (sofern die Hardware schnell genug ist).
  296.       Hier kann man nun "Vollgas" geben. Eigentlich ist es nur eine 
  297.       Spielerei, aber man kann sehen, wie schnell der Computer die 
  298.       Animation abspielen kann ("Ätsch meiner ist aber schneller als 
  299.       deiner").
  300.     
  301.     NOVA-Support:                    [Alternate P]
  302.       Wenn McFli feststellt, daß es auf einer NOVA-Grafikkarte gestartet 
  303.       wurde, liest es am Programmstart die Auflösungsbibliothek ein.
  304.       
  305.       Startet man nun eine Animation, die nicht im Fenster laufen soll und 
  306.       NOVA-Support ist eingeschaltet, so sucht sich McFli die kleinste 
  307.       Auflösung in die die Animation hinein passt heraus, und schaltet auf
  308.       diese um. 
  309.     
  310.       Dieser Button ist nur anwählbar, wenn eine NOVA Grafikkarte gefunden 
  311.       wurde und deren Auflösungsbibliothek geladen werden konnte.
  312.         
  313.     
  314.     Defaultmäßig sind "Sofort", "Endlos" und "Im Fenster" aktiviert.
  315.     
  316.     
  317.   Vom Speicher spielen :
  318.     Immer                            [Alternate I]
  319.     Wenn möglich (Evtl.)             [Alternate E]
  320.     Nie                              [Alternate N]
  321.     
  322.     Je nach Einstellung versucht McFli die Animation komplett in den 
  323.     Hauptspeicher zu laden, da dieses meist mit einer höheren 
  324.     Abspielgeschwindigkeit verbunden ist. Man hat aber die Möglichkeit 
  325.     dies zu unterbinden (Nie) oder auch zu forcieren (immer).
  326.     
  327.     Ist "Immer" gewählt, aber der Speicher reicht nicht gibt's zur Strafe 
  328.     'ne Alertbox, die darauf hinweist.
  329.     
  330.     Default ist "Wenn möglich" (erscheint mir auch die sinnvollste 
  331.     Einstellung zu sein)
  332.   
  333.     Diese Einstellung wird erst aktiv, wenn eine neue Animation geladen 
  334.     wird, betrifft also die aktuelle Animation nicht.
  335.   
  336.   
  337.   Schließen :
  338.     und Öffnen:                      [Alternate U]
  339.       Wenn man eine Animation schließt, öffnet sich sogleich der 
  340.       Fileselektor für die nächste. (Default: An)
  341.       
  342.     und Ende:                        [Alternate D]
  343.       Das Schließen einer Animation beendet McFli. (Default: Aus)
  344.  
  345.  
  346. 4.2.5 Der Fullscreen-Modus:
  347.     Die Animation wird zwar immer im Fenster angezeigt, kann aber auch auf 
  348.     dem kompletten Bildschirm gespielt werden. Das ist z.B. recht nütz-
  349.     lich, wenn man eine Animation von 320x200 unter einer Auflösung 
  350.     von 320x200 ansehen möchte. Außerdem wird so eine höhere Geschwindigkeit
  351.     erzielt. 
  352.     
  353.     Ein vorhandener VSCR Cookie wird ausgewertet, d.h. die Animation wird 
  354.     auch unter virtuellen Auflösungen in der Bildschrimmitte dargestellt!
  355.     (Benutzer von Grafikkarten, die es ermöglichen eine große virtuelle 
  356.     Auflösung auf eine kleine reale Auflösung abzubilden (z.B. NOVA),
  357.     mögen dies mal ausprobieren).
  358.  
  359.         
  360.     Steuerung der Animation im "Fullscreen-Modus":
  361.     
  362.       ESC, W: Wechselt vom "Fullscreen-Modus" in den "Fenster-Modus"
  363.       
  364.       S:      Stop
  365.       
  366.       G:      Play
  367.       
  368.       P:      Pause
  369.          
  370.       F:      Nächstes Frame  (nicht für alle Animationstypen)
  371.       
  372.       R:      Letztes Frame   (nicht für alle Animationstypen)
  373.       
  374.       U, D:   Die Animation wird geschlossen; sind weder "Schließen und 
  375.               Öffnen" noch "Schließen und Ende" aktiv, wird in den 
  376.               "Fenster-Modus" gewechselt.
  377.       
  378.       Q:      McFli wird beendet.
  379.         
  380.       jede andere Taste, Maustaste oder Sondertaste hält die Animation 
  381.       an (wie Pause) und verlässt den "Fullscreen-Modus".
  382.     
  383.  
  384. 5. Abweichende Bedienung für verschiedene Animationen
  385.  
  386. Da die, von McFli abspielbaren Animationen, alle diverse Unterschiede 
  387. aufweisen, unterscheidet sich auch die Bedienung geringfügig.
  388.  
  389.   5.1 FLI/FLC
  390.       - Die Möglichkeit, zum letzten Frame zu springen, besteht nicht
  391.  
  392.   5.2 GL
  393.       Bevor ich zu den Unterschieden komme, ein paar Worte zu GL. Die 
  394.       Animation läuft nicht Bild für Bild ab, sondern wird durch einen 
  395.       (internen) Befehlstext gesteuert. Leider ist es mir nicht möglich 
  396.       gewesen, bisher alle Befehle zu implementieren, aber das Meiste und 
  397.       Wichtigste geht schonmal. Da GL-Animationen hauptsächlich durch die 
  398.       Animation kleiner Ausschnitte leben, müssen diese zwischengespeichert 
  399.       werden. Aus diesem Grund legt McFli einen Pufferspeicher an, der ca. 
  400.       700kB groß ist! Um GL-Animationen abspielen zu können, braucht man 
  401.       deswegen mindestens 1MB freien Hauptspeicher.
  402.       
  403.       - GL Animationen können auf einen Tastendruck warten. Um eine 
  404.         Eingabe machen zu können, muß das Animationsfenster das oberste 
  405.         sein (es sei denn, man befindet sich im Fullscreen-Modus), sowie 
  406.         zusätzlich die Alternate-Taste gedrückt werden.
  407.  
  408.  
  409. 6. McStart:
  410.  
  411. Leider gibt es auch defekte Animationen, die McFli nicht immer als solche 
  412. erkennt (und abstürzt). Aus diesem Grund gibt es McStart. 
  413.  
  414. MC_START.APP lädt McFli und startet es. Wird McFli mit einem Fehler 
  415. beendet, so setzt McStart die Farbpalette auf einen Standardwert und 
  416. stellt bei NOVA Graphikkarten die Bootauflösung wieder ein.
  417.  
  418.  
  419. 7. Anhang:
  420.  
  421. McFli ist zur Zeit noch im Vorstadium. Bis zur Version 1.0 werden 
  422. wahrscheinlich noch folgende Dinge eingebaut:
  423.  
  424. - Erhöhter GL-Befehlssatz
  425.  
  426. Unter Umständen baue ich auch noch andere Animationsformate ein, geplant 
  427. ist dies allerdings erst für Version 2.0 (wenn sie denn mal kommt).
  428.  
  429.  
  430. 8. History:
  431.  
  432. v0.7  -kleine Bugfixes
  433.  
  434. v0.5 vom 17.04.95:
  435.      - Neu: Animationstyp "GL"
  436.      - Tastaturbedienung der Dialoge und des "Fullscreen-Modus"
  437.      - Echte Hintergrundbedienung
  438.      - "Parameter sichern" aus dem Parameterdialog in die Menüleiste verlegt
  439.      - Umschaltung "Fullscreen-Modus"/"Fenster-Modus" aus laufender Animation
  440.      - Volle VSCR Unterstützung
  441.      - Neu: "NOVA-Support"
  442.      - Neu: Drag&Drop (Typ ARGS)
  443.      - Neu: Fenster iconisieren (nach ATARI- und ICFS-Spezifikation)
  444.      - Variable Größe des Animationsfensters (abschaltbar)
  445.      - Kosmetische Änderungen
  446.      - Bugfixes
  447.  
  448. v0.2-0.4 Interne Versionen
  449.      
  450. v0.1 vom 24.02.95:
  451.      Erste öffentliche Version
  452.  
  453.  
  454. 9. Ausleitung:
  455.  
  456. Ich hoffe, daß es nicht zu viel Mühe war, bis hierher zu kommen, und McFli 
  457. sauber, absturzlos und zur Zufriedenheit funktioniert.
  458. Leider sind Fehler in Software nie ganz auszuschließen. Für irgendwelche 
  459. Schäden jeglicher Art übernehme ich allerdings keinerlei Haftung, selbst 
  460. wenn mir absolut keine möglichen Schäden einfallen wollen (außer 
  461. kaputten Augen vielleicht).
  462.  
  463.  
  464.  
  465. Anregungen, Kritik und Bugreports an:
  466.  
  467. John McLoud
  468. Mozartstraße 1a
  469. 65439 Flörsheim am Main
  470.  
  471. e-mail:  John Mcloud @ WI2  (Mausnet)
  472.  
  473.  
  474. Zahlungen an:
  475.  
  476. John McLoud
  477. Taunussparkasse BLZ 512 500 00
  478. Konto: 9 45 02 97
  479.  
  480.  
  481.